home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr07 / rebel302.zip / STDLIB.DOC < prev    next >
Text File  |  1993-06-01  |  6KB  |  200 lines

  1.  
  2.  
  3.                    _ __     __     __      __      _                     
  4.                   ' )  )   /  `   /  )    /  `    /      tm
  5.                    /--'   /--    /--<    /--     /
  6.                  /    \  (____, (____)  (____,  (____,
  7.  
  8.                    (c) Copyright 1993  Brad L. Smith
  9.                           All Rights Reserved
  10.  
  11.  
  12.                        THE 'STDLIB' SCRIPT LIBRARY
  13.  
  14.                              Version 1.01
  15.  
  16.  
  17.  
  18.     1)  To access the scripts in this library:    REBEL -L:STDLIB
  19.  
  20.  
  21.         Notice that the names of the scripts used in this library use
  22.         upper case letters, this was done so you can distinguish them
  23.         from built-in functions (which, for the most part, use lower
  24.         case letters).
  25.  
  26.  
  27.     ______________________________________________________________________
  28.     FINANCIAL FUNCTIONS:
  29.      
  30.  
  31.        CTERM (interest,fv,pv)  =  term
  32.  
  33.             Calculates the number of periods (term) required for a
  34.             lump sum (pv) to reach a future amount (fv) at a given
  35.             periodic interest rate.
  36.      
  37.             Example:    +CTERM(0.09/12,6543.28,5000.00)  =   36  
  38.  
  39.  
  40.        FV (payment,interest,term)  =  future_value 
  41.      
  42.             Calculates the future value (amount accumulated), given
  43.             the size of the payment, the interest rate per period, and
  44.             the term (i.e. the total number of periods).
  45.  
  46.             Example:   +FV(159.00,0.09/12,12*3)  =    $6543.28
  47.  
  48.  
  49.       PMT (principle,interest,term)  =  payment
  50.  
  51.             Calculates the size a payment required to pay off the
  52.             principle on a loan, given the interest rate per period
  53.             and the term (i.e. the total number of periods).
  54.  
  55.             Example:    +PMT(5000.00,0.09/12,12*3)  =   $159.00
  56.  
  57.  
  58.       PV (payment,interest,term)  =  present_value
  59.  
  60.             Calculates the present value (principle of a loan), given
  61.             the interest rate per period and the term (i.e. the total
  62.             number of periods).
  63.  
  64.             Example:    +PV(159.00,0.09/12,12*3)  =   $5000.04
  65.  
  66.  
  67.       RATE (fv,pv,term)  =  interest_rate 
  68.  
  69.             Calculates the interest rate, per period, required to
  70.             increase an initial lump sum (pv) to a future value (fv)
  71.             over a given number of periods (term).
  72.      
  73.             Example:    +PMT(6543.28,5000.00,12*3)  =   0.0075  
  74.  
  75.  
  76.       TERM (payment,interest,fv)  =  term 
  77.  
  78.             Calculates the number of periods (term) required to reach a
  79.             future value (i.e. an accumulated amount).
  80.    
  81.             Example:   +TERM(159.00,0.09/12,6543.28)   =   36  
  82.  
  83.  
  84.     ______________________________________________________________________
  85.     STATISTICAL FUNCTIONS:
  86.  
  87.  
  88.       In each of the following functions, two complete cell references
  89.       (r,c,e,z and rr,cc,ee,zz) are used to identify a 'range' of cells
  90.       on the worksheet or a series of values within the 'array' area of
  91.       a single cell.
  92.  
  93.            where:
  94.  
  95.                "r" and "rr"  are row numbers
  96.                "c" and "cc"  are column numbers
  97.                "e" and "ee"  are array element numbers
  98.                "z" and "zz"  are worksheet level numbers
  99.  
  100.       The values used for the array element parameters ('e' and 'ee')
  101.       determine which case is used.  For example, when defining a 'range'
  102.       of cells, the 'e' and 'ee' parameters MUST be set to zero (0).
  103.       The (r,c,z) and (rr,cc,zz) parameters are then used to identify the
  104.       upper left and lower right corners of the range.
  105.  
  106.       When operating on an 'array', the two cell references defined by
  107.       the (r,c,z) and (rr,cc,zz) parameter MUST BE EQUAL; AND the 'e'
  108.       parameter MUST be set to a value equal to or greater than one (1)
  109.       and the 'ee' MUST be set to a value equal to or greater than 'e'.
  110.  
  111.  
  112.       SUM (r,c,e,z,rr,cc,ee,zz)
  113.  
  114.             Sums the values within a 'range' of cells or within a
  115.             cell's 'array' area (see above note).
  116.  
  117.             Example:  Sum the values between [1,1] and [9,7]
  118.  
  119.                       +SUM(1,1,0,1,9,7,0,1)   
  120.  
  121.             Example:  Sum the first 10 array values of [3,4]
  122.  
  123.                       +SUM(3,4,2,1,3,4,10,1)   
  124.  
  125.  
  126.       MEAN (r,c,e,z,rr,cc,ee,zz)
  127.  
  128.             Returns the mean value found within a 'range' of cells
  129.             or within a cell's 'array' area.
  130.  
  131.       VAR (r,c,e,z,rr,cc,ee,zz)
  132.  
  133.             Returns the variance of the values defined within a
  134.             'range' of cells or within a cell's 'array' area.
  135.  
  136.       DEV (r,c,e,z,rr,cc,ee,zz)
  137.  
  138.             Returns the standard deviation of the values defined
  139.             within a 'range' of cells or within a cell's 'array' area.
  140.  
  141.       MAX (r,c,e,z,rr,cc,ee,zz)
  142.  
  143.             Returns the maximum value found within a 'range' of cells
  144.             or within a cell's 'array' area.
  145.  
  146.       MIN (r,c,e,z,rr,cc,ee,zz)
  147.  
  148.             Returns the minimum value found within a 'range' of cells
  149.             or within a cell's 'array' area.
  150.  
  151.  
  152.     ______________________________________________________________________
  153.     CONVERSIONS ROUTINES:
  154.  
  155.  
  156.       CM_IN (centimeter)  =  inches
  157.  
  158.       IN_CM (inches)  =  centimeter
  159.  
  160.       METERS_FT (meters)  =  feet
  161.  
  162.       FT_METERS (feet)  =  meters
  163.  
  164.       FT_MILES (feet)  =  miles
  165.  
  166.       MILES_KM (miles)  =  kilometers
  167.  
  168.       KM_MILES (kilometers)  =  miles
  169.  
  170.       SQFT_ACRES (sqft)  =  acres
  171.  
  172.       ACRES_SQFT (acres)  =  sq feet
  173.  
  174.       ACRES_SQKM (acres)  =  sq kilometers
  175.  
  176.       GRAMS_OZ (grams)  =  ounces
  177.  
  178.       GRAINS_OZ (grains)  = ounces
  179.  
  180.       OZ_LITERS (oz)  =  liters
  181.  
  182.       OZ_CUPS (oz)  =  cups
  183.  
  184.       OZ_TEASPOONS (oz)  =  teaspoons
  185.  
  186.       OZ_TABELSPOONS (oz)  =  tablespoons
  187.  
  188.       OZ_GALLONS (oz)  =  gallons
  189.  
  190.       GALLONS_OZ (gallons)  =  ounces
  191.  
  192.       GALLONS_LITERS (gallons)  =  liters
  193.  
  194.       LITERS_GALLONS (liters)  =  gallons
  195.  
  196.       LITERS_CUIN (liters)  =  cu inches
  197.  
  198.       CUIN_LITERS (cuin)  =  liters
  199.  
  200.